home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / banpr / tn211.exe / 211.ASC
Text File  |  1991-04-25  |  8KB  |  168 lines
  1.         
  2.         TECHNOTES
  3.         ──────────────────────────────────────────────────────────────────────
  4.         BULLETIN #:           211
  5.         
  6.         Date:                 4 April 1991
  7.         
  8.         Summary:              Problem with pgms.db file owned by root.
  9.         
  10.         Server:               All
  11.         
  12.         Software Version:     4.00 (1) and 4.00 (2)
  13.         
  14.         Category:             Administration
  15.         ──────────────────────────────────────────────────────────────────────
  16.         
  17.         
  18.         PROBLEM:
  19.         
  20.         In the VINES internal software, the /disk1/local/ss directory contains
  21.         files that identify third-party application programs to the VINES
  22.         Server Service.  In this directory, the pgms.db database file
  23.         identifies the types of third-party services that can exist on a
  24.         VINES server.  (The "VINES Applications Developer's Guide" contains
  25.         details on the purpose and format of the pgms.db file.)
  26.         
  27.         When you install a third-party service on a VINES 4.00 (1) or 4.00 (2)
  28.         server, the INSTALL program may exit with an the following message:
  29.         
  30.             Error:  Cannot update pgms.db
  31.             INSTALL ABORTED ...
  32.         
  33.         This error occurs because ownership of the pgms.db file has been
  34.         transferred from "local" to "root", and therefore cannot be modified
  35.         by the INSTALL program.
  36.         
  37.         In addition, the error often truncates the size of the pgms.db file to
  38.         0 bytes, thus corrupting the file.  As a result, third-party services
  39.         will not come up running the next time that services are restarted
  40.         (for example, if the server is rebooted).
  41.         
  42.         This error was introduced in the 4.00 (1) patch and is also present
  43.         in the 4.00 (2) maintenance patch.  If either of these patches has
  44.         been installed, the ownership of the pgms.db file has been changed
  45.         to root.  Therefore, any attempt to install a third-party service will
  46.         result in this error condition. 
  47.         
  48.         
  49.         
  50.         AFFECTED PLATFORMS:
  51.         
  52.         Any platform running VINES 4.00 (1) or 4.00 (2) is affected.
  53.         
  54.         
  55.         
  56.         SOLUTION TO OWNERSHIP OF PGMS.DB FILE:
  57.         
  58.         The problem of the ownership of the pgms.db file having been changed
  59.         from "local" to "root" will be fixed in the subsequent maintenance
  60.         patch and in all future releases of VINES software.  In the meantime,
  61.         you can install site-specific patch VINES 4.00 Applications Toolkit P1.
  62.         This patch changes the ownership of all files in the directory
  63.         /disk1/local/ss to the correct local owner.
  64.         
  65.         Although the patch is named Applications Toolkit P1, you can apply it
  66.         on servers that do not have the VINES Applications Toolkit installed,
  67.         but have third-party services (or on which you intend to install
  68.         third-party services).
  69.         
  70.            NOTE:  It is strongly recommended that you install the P1 patch
  71.            before you attempt to install any third-party service on a 4.00 (1)
  72.            or 4.00 (2) server.  Because the patch does not reboot the server,
  73.            you can apply it at any time without affecting other services or
  74.            users on the server.
  75.         
  76.         
  77.         
  78.         SOLUTION TO CORRUPTION OF PGMS.DB FILE:
  79.         
  80.         The application of the Toolkit P1 patch will prevent the corruption
  81.         of the pgms.db file in future installations of third-party services.
  82.         However, the patch will not rebuild the file if it has already been
  83.         damaged.
  84.         
  85.         To correct this problem, the pgms.db file must be restored to an
  86.         uncorrupted condition, and the third-party service can then be
  87.         installed correctly.  How you do this depends on whether the
  88.         third-party service that you tried to install was the ONLY third-party
  89.         service on the server when the problem occurred or if OTHER third-party
  90.         services were running on the server.  Both situations are covered in
  91.         the next two sections.
  92.         
  93.         
  94.         No Other Third-Party Services:
  95.         
  96.         If the service that you attempted to install is the ONLY third-party
  97.         service on the server, all you have to do is to install the 4.00
  98.         Applications Toolkit P1 patch and then re-install the third-party
  99.         service.  There are no further steps to perform.
  100.         
  101.         
  102.         Other Third-Party Services:
  103.         
  104.         If there were OTHER third-party services installed on this server when
  105.         the problem occurred, the recovery procedure that you use depends on
  106.         whether there is a DOS/UNIX Bridge File Service on the server.
  107.         
  108.         If a DOS/UNIX Bridge File Service is on the server, examine the pgms.db
  109.         file to determine if it is missing data or is corrupted.  If the file
  110.         is 0 bytes in length, it is corrupted.  If the file is undamaged, all
  111.         you need to do is to install the 4.00 Applications Toolkit P1 patch
  112.         and then re-install the service that incurred the original error.
  113.         No further action is necessary.
  114.         
  115.         If the pgms.db file is corrupted or if you do not have a a DOS/UNIX
  116.         Bridge File Service on the server, you may be able to rebuild the
  117.         pgms.db file by simply re-installing each existing third-party service.
  118.         However, it is strongly recommended that you contact the developer of
  119.         the third-party service before you re-install the service.  The
  120.         installation procedure may initialize or destroy critical data files
  121.         that are used by the service.  The developer should be able to tell you
  122.         if the service installation procedure performs a cleanup of its data
  123.         directories. 
  124.         
  125.         Use the following procedure:
  126.         
  127.            1. Install the 4.00 Applications Toolkit P1 patch.
  128.         
  129.            2. If you determined from the developer of the third-party service
  130.               that you can safely re-install the service, continue with these
  131.               steps:
  132.         
  133.                  a. Use the MSERVICE command to stop all third-party services.
  134.         
  135.                  b. Re-install each third-party service from the vendor's
  136.                     original distribution media.
  137.         
  138.                  c. Use the MSERVICE command to restart all third-party
  139.                     services.
  140.         
  141.               If you cannot safely re-install the service, you cannot rebuild
  142.               the pgms.db file yourself.  A dial-in to the server will be
  143.               necessary to repair the pgms.db file.  Perform these steps:
  144.         
  145.                  a. Obtain from the developer the content of their service's
  146.                     pgms.db line (that is, service category, service description,
  147.                     name of the service executable, and service home directory).
  148.         
  149.                  b. To prepare for the dial-in, make sure you have a Hayes
  150.                     modem (or a 100% Hayes-compatible modem) and a serial cable
  151.                     connected to the serial port of the server.
  152.         
  153.                  c. Contact your Support Center for assistance in repairing
  154.                     the pgms.db file.  The Support Center will dial-in to the
  155.                     server and repair the file.
  156.         
  157.         
  158.         NOTE FOR THIRD-PARTY DEVELOPERS:
  159.         
  160.         If you are shipping applications to run on VINES 4.00 (1) or 4.00 (2)
  161.         servers, please also send the 4.00 Toolkit P1 patch with the application,
  162.         and instruct your customers to install this patch prior to installing
  163.         your application.
  164.         
  165.         
  166.                            End of TechNote #211
  167.         ──────────────────────────────────────────────────────────────────────
  168.